home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / FROMUTS / WARFARIN / !Warfarin / !ReadMe next >
Text File  |  1990-08-25  |  4KB  |  112 lines
  1.                         Documentation for Warfarin V1.00
  2.                         --------------------------------
  3.  
  4. Installing Warfarin
  5. -------------------
  6.  
  7. Simply load the module by typing *Warfarin from inside the !Warfarin directory.
  8. There are no * commands supplied: Warfarin activates as soon as it has loaded.
  9. The only way to remove it is *RMKill it (or hard reset/switch off). You can do
  10. *Help Warfarin, but it doesn't tell you anything astounding.
  11.  
  12. I have supplied an application directory, !Warfarin, containing a trivial
  13. !Run and a silly !Sprites file, but it seems pointless because you need
  14. the mouse to work in order to load it ! Actually, you can type *!Warfarin
  15. from the command line, so all is not lost. If you are being sensible, you
  16. should copy the Warfarin module to your Library directory so that you can
  17. type *Warfarin from anywhere.
  18.  
  19. What does Warfarin do ?
  20. -----------------------
  21.  
  22. It allows the mouse pointer to be moved by using either Alt key in combination
  23. the cursor keys (and Insert, Home and Page Up) to move the mouse (and press the
  24. left, middle and right buttons). Since the source is supplied, it is relatively
  25. easy to change the keys used (the 'eventtrap' routine is fully commented). You
  26. may also want to change the mouse step 'boost' (because the step of 1 pixel
  27. using the arrow keys is tortuous, I add 4 to the mouse step before multiplic-
  28. ation of the X and Y change) - it's a variable called 'mouseboost%'. You could
  29. change your *Configure MouseStep setting instead of course.
  30.  
  31. Why's it called Warfarin ?
  32. --------------------------
  33.  
  34. Warfarin is a crystalline insoluble substance (C  H  O ) used as a rodenticide.
  35.                                                 19 16 4
  36.  
  37. Hence, my module is used when your mouse is dead !
  38.  
  39. I should remind readers that Warfarin is the patent name owned by
  40. Wisconsin Alumni Research Foundation, derived from their initials and the
  41. compound courmarin (C H O ).
  42.                      9 6 2
  43.  
  44. How do I use it ?
  45. -----------------
  46.  
  47. Press Alt and, whilst still holding down Alt, press one of the four
  48. cursor keys to move the mouse pointer. It will move smoothly at the rate
  49. that you've set for *Configure MouseStep. Pressing Alt-Insert will act as
  50. if you've pressed the left mouse button. Alt-Home (middle button) and
  51. Alt-Page Up (right button) also simulate mouse button presses.
  52.  
  53. NOTE: When Alt is held down, the normal text cursor will still move when the
  54.       cursor keys are pressed. The normal mouse buttons are also DISABLED
  55.       whilst Alt is depressed, but you can still move the mouse.
  56.  
  57. Technical Section
  58. -----------------
  59.  
  60. Well, I had some problems getting this one to work ! I tried:
  61.  
  62. 1) OS_GenerateEvent 10 to force a button pressed event...the OS ignores it.
  63.  
  64. 2) Forcing nine bytes into the mouse buffer every vsync - also failed.
  65.  
  66. 3) Setting the mouse position with OS_Word 21 (param 3). This worked, but
  67.    you can't set the mouse button state with it.
  68.  
  69. 4) Trapping OS_Mouse itself. This worked after I used the example in the
  70.    manual - boy, modifying return parameters on a vector is hard work. I
  71.    used the OS_Mouse vector to 'tweak' the mouse button states, but it's
  72.    no good for updating the mouse position.
  73.  
  74. The Warfarin module survives a soft reset.
  75.  
  76. Revision History
  77. ----------------
  78.  
  79. Version 1.00
  80. ------------
  81.  
  82. * The mouse on the A440 I use at work refused to move in a sensible fashion
  83.   and it was like trying to play a game of 'can I get the mouse to move in
  84.   the direction I want ?'. Since the Atari ST can move the mouse via the
  85.   keys, I simply couldn't let a vastly inferior machine get away with a
  86.   useful feature that the Archimedes doesn't have.
  87.  
  88. Future Enhancements
  89. -------------------
  90.  
  91. * When Alt is held down, the cursor keys shouldn't move the normal text cursor.
  92.  
  93. * I'll probably have a 'speedup key' to double the speed of the mouse movement
  94.   if it has a long way to travel.
  95.  
  96. A Plea From The Author
  97. ----------------------
  98.  
  99. If you make some USEFUL changes to the source or fix any bugs, can you please
  100. send me those changes to the following address:
  101.  
  102. Snail Mail                   JANET e-mail
  103. ----------                   ------------
  104.  
  105. Richard K. Lloyd,            rkl@uk.ac.liv.cs.mva
  106. 1, Banks Road,
  107. Lower Heswall,
  108. Wirral,
  109. Merseyside. L60 9JS
  110.  
  111. P.S. Anyone know where I can buy an Archimedes mouse cheaply ?
  112.